Draft API/de

Other languages:
(November 2018) Diese Information kann unvollständig und veraltet sein. Für die neueste API siehe die (engl.) autogenerierte API-Dokumentation.

Diese Funktionen sind Teil des Draft-Arbeitsbereichs und können in Makros oder mit dem Phyton-Interpreter verwendet werden, sobald der Draft-Arbeitsbereich importiert wurde.

Beispiel: 

import FreeCAD, Draft

myrect = Draft.makeRectangle(4, 3)
mydistance = FreeCAD.Vector(2, 2, 0)
Draft.move(myrect, mydistance)
cut(FreeCAD.Object, FreeCAD.Object)

Description: Gibt ein ausgeschnittenes Objekt zurück, das aus der Differenz der beiden angegebenen Objekte erstellt wurde. Die ursprünglichen Objekte werden ausgeblendet.

Returns: Das neu erstellte Objekt

extrude(FreeCAD.Object, Vector)

Description: Extrudiert das angegebene Objekt in die durch den Vektor angegebene Richtung. Das ursprüngliche Objekt wird ausgeblendet.

Returns: Das neu erstellte Objekt

formatObject(FreeCAD.Object, [FreeCAD.Object])

Description: Diese Funktion wendet auf das angegebene Zielobjekt die aktuellen Eigenschaften an, die in der Symbolleiste Draft festgelegt sind (Linienfarbe und Linienbreite), oder kopiert die Eigenschaften eines zweiten Objekts, sofern vorhanden. Außerdem wird das Objekt in die Konstruktionsgruppe eingefügt, wenn die Konstruktionstaste gedrückt wird.

Returns: Nichts

fuse(FreeCAD.Object, FreeCAD.Object)

Description: Gibt ein Objekt zurück, das aus der Vereinigung der beiden angegebenen Objekte besteht. Wenn die Objekte koplanar sind, wird ein spezieller Draft Linienzug verwendet, andernfalls ist das endgültige Objekt eine Standard Part Vereinigung.

Returns: Das neu erzeugte Objekt

getDraftPath([string])

Description: Gibt den Benutzer- oder Systempfad zurück, von dem aus das Draft-Modul ausgeführt wird. Wenn ein Unterpfad oder ein Dateiname angegeben wird, wird der vollständige Pfad zum Unterpfad innerhalb des Draft-Moduls zurückgegeben.

Returns: Ein Dateipfad

getGroupContents(list)

Description: Durchsucht die angegebene Liste rekursiv nach Gruppen. Wenn Gruppen gefunden werden, wird ihr Inhalt an die Liste angehängt.

Returns: Eine Liste von FreeCAD-Objekten

getRealName(string)

Description: Entfernt die nachfolgenden Zahlen aus einem Objektnamen.

Returns: Der entfernte Objektname

getSelection( )

Description: Gibt die aktuelle FreeCAD-Auswahl zurück.

Returns: Die aktuelle FreeCAD-Auswahl

makeCircle(radius, [placement], [facemode], [startangle], [endangle])

Description: Erstellt ein Kreisobjekt mit dem angegebenen Radius. Wenn eine Positionierung angegeben ist, wird diese verwendet. Wenn facemode False ist, wird der Kreis als Drahtgittermodell angezeigt, andernfalls als Fläche. Wenn startangle UND endangle angegeben sind (in Grad), werden diese verwendet und das Objekt wird als Bogen angezeigt.

Returns: Das neu erstellte Objekt.

makeDimension(Vector, Vector, [Vector] or FreeCAD.Object, int, int, [Vector])

Description: Erstellt ein Bemaßungsobjekt, das den Abstand zwischen dem ersten und zweiten Vektor misst, wobei die Bemaßungslinie durch den dritten Vektor verläuft, sofern dieser angegeben ist. Es werden die aktuelle Linienbreite und Farbe aus der Symbolleiste Draft verwendet. Anstelle von zwei Vektoren kann auch ein FreeCAD-Objekt und zwei Ganzzahlen (und optional einen Vektor, durch den die Bemaßungslinie verlaufen soll) übergeben werden. In diesem Fall wird die Bemaßung mit dem Objekt verknüpft und misst zwei seiner Eckpunkte, die durch die beiden angegebenen Indizzahlen angegeben werden.

Returns: Das neu erstellte Objekt.

makeLine(Vector, Vector)

Description: Erstellt eine Linie zwischen den beiden angegebenen Vektoren. Es werden die aktuelle Linienbreite und Farbe aus der Symbolleiste Draft verwendet.

Returns: Das neu erstellte Objekt.

makeRectangle(length, width, [placement], [facemode])

Description: Erstellt ein Rechteckobjekt mit Länge in X-Richtung und Höhe in Y-Richtung. Wenn eine Platzierung angegeben ist, wird diese verwendet. Wenn facemode auf False gesetzt ist, wird das Rechteck als Drahtgittermodell angezeigt, andernfalls als Fläche. Es werden die aktuelle Linienbreite und Farbe aus der Symbolleiste Entwurf verwendet.

Returns: Das neu erstellte Objekt.

makeText(string or list, [Vector], [screenmode])

Description: Erstellt ein Textobjekt an der angegebenen Stelle, wenn ein Vektor angegeben ist, das die in der Liste angegebenen Zeichenfolgen enthält, wobei jede Zeichenfolge in einer eigenen Zeile steht. Es werden die aktuelle Farbe aus der Symbolleiste Draft sowie die in den Einstellungen festgelegte Texthöhe und Schriftart verwendet. Wenn screenmode auf True gesetzt ist, ist der Text immer in Blickrichtung ausgerichtet, andernfalls liegt er auf der XY-Ebene.

Returns: Das neu erstellte Objekt.

makeWire(list or Part.Wire, [closed], [placement], [facemode])

Description: Erstellt ein DWire-Objekt aus der angegebenen Liste von Vektoren oder aus dem angegebenen Linienzug. Wenn closed True ist oder wenn der erste und der letzte Punkt identisch sind, ist der Linienzug geschlossen. Wenn facemode True ist (und der Linienzug geschlossen ist), wird der Linienzug gefüllt angezeigt. Es werden die aktuelle Linienbreite und Farbe aus der Draft-Symbolleiste verwendet.

Returns: Ein neuer Draft DWire (kein Part Wire).

move(FreeCAD.Object or list, Vector, [copymode])

Description: Verschiebt das angegebene Objekt oder die in der angegebenen Liste enthaltenen Objekte in die durch den angegebenen Vektor angegebene Richtung und Entfernung. Wenn copymode True ist, werden die tatsächlichen Objekte nicht verschoben, sondern es werden Kopien erstellt.

Returns: Das Objekt/die Objekte (oder deren Kopien, wenn copymode True war).

precision( )

Description: Gibt den Genauigkeitswert aus den Draft-Einstellungen des Benutzers zurück.

Returns: Eine Ganzzahl.

rotate(FreeCAD.Object or list, angle, [center], [axis] ,[copymode])

Description: Dreht das angegebene Objekt oder die in der angegebenen Liste enthaltenen Objekte um den angegebenen Winkel um den angegebenen Mittelpunkt, sofern vorhanden, wobei axis als Drehachse verwendet wird. Wenn axis weggelassen wird, erfolgt die Drehung um die vertikale Z-Achse. Wenn copymode True ist, werden die tatsächlichen Objekte nicht verschoben, sondern es werden Kopien erstellt.

Returns: Die Objekte (oder ihre Kopien).

scale(FreeCAD.Object or list, vector, [center], [copymode])

Description: Skaliert das angegebene Objekt oder die in der angegebenen Liste enthaltenen Objekte mit einem durch den angegebenen Vektor definierten Skalierungsfaktor (in X-, Y- und Z-Richtung) um den angegebenen Mittelpunkt, sofern vorhanden. Wenn copymode auf True gesetzt ist, werden die tatsächlichen Objekte nicht verschoben, sondern es werden Kopien erstellt.

Returns: Die Objekte (oder ihre Kopien).

select(FreeCAD.Object)

Description: Hebt die Auswahl aller Elemente auf und wählt nur das übergebene Objekt aus.

Returns: Nichts.

shapify(FreeCAD.Object)

Description: Wandelt ein parametrisches Formobjekt in ein nicht-parametrisches um.

Returns: Das neue Objekt.

draftify(FreeCAD.Object or list)

Description: Wandelt das angegebene Objekt oder jedes Objekt der angegebenen Liste in parametrische Draft Linienzüge um.

Returns: Nichts.

getSVG(FreeCAD.Object, [linemodifier], [textmodifier], [(u,v)])

Description: Erstellt eine SVG-Darstellung des angegebenen Objekts. Das Attribut linemodifier ist ein Skalierungsfaktor (in Prozent) für die Linienbreite und textmodifier für die Textgröße. Optional kann auch ein Tupel von Vektoren angeben werden, um eine Projektionsebene zu definieren. Andernfalls wird die Geometrie auf die XY-Ebene projiziert.

Returns: Eine Zeichenfolge, die eine SVG-Darstellung des angegebenen Objekts enthält.

Draft
Anwenderdokumentation